UNIVERSITY OF ILLINOIS 
DIGITAL COMPUTER 

LIBRARY ROUTIN E Dl-9^ 

TITLE Check Point Code II 

TYPE Special 

NUMBER OF WORDS 57 + 3jL + s + 3 ( see text ) 

DESCRIPTION: 

This code is designed to print out intermediate information 
about the operation of some other code. Its purpose is to help the pro- 
grammer locate mistakes in a code which is not working properly > or else to 
verify that a code suspected of working properly is actually doing so. The 
principle of operation of the cheek point code is to place "blocking orders" 
at particular points of your program (these points to he specified by you on 
a specification tape to be discussed later)* Each blocking order results in 
a transfer of control to Code 95* When control is transferred, Code 95 prints 
out the location (fixed) of the order at which the block has been placed, 
and then prints out other information which you think will help you in 
locating the mistake in your program* The nature of the other information 
to be printed out at the checkpoint is also specified on the specification 
tape. This other information is printed out before the blocked order is 
finally obeyed . The blocking order itself is placed in the left hand side of 
the blocked placed in the memory. 

For each checkpoint, the programmer can specify how many times 
no printing is to occur (e.g., do not print the first ik times) and how often 
to print thereafter (e.g., print 18 times and then print no more). In this 
particular case, the following things would happen? When Code 95 is read 
in, it places a blocking order at the checkpoint. The first Ik times the 
blocking order is reached, control is transferred to Code 95. Code 95 prints 
nothings, executes the blocked order, and transfers control back to your 
program. The 15th time the blocking order is reached, control is transferred 
to Code 95 • Code 95 prints two line feed characters, the location of the 
blocking order, and prints such other information as you have asked it to 
print (on the specification tape). It then executes the blocked order, and 
transfers control back to your program. The l6th time the blocking order is 
reached, printing occurs, and so on. The 52nd time (52 =1^+18) the blocking 
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order is encountered, printing occurs, the "blocked order is obeyed, and the 
blocked order is restored to its rightful place in the memory the 33rd time. 
The 3Vfch time the previously blocked order is encountered, it is simply obeyed 
just as if it had never been blocked, and the same occurs forever thereafter, 
until your program terminates "with an OFF order, or fails someplace else. 

Certain precautions must be obeyed in deciding on the location 

of blocking orders; 

(1) The blocked order must not be overwritten by your program 
charing the time> it is blocked (however, it may be overwritten after code 95 has 
relinquished control)* 

(2) The blocked order must not be used as a number by your 
program during the time it is blocked (however, it may be used as a number 
after Code 95 has relinquished control). 

(3) it is not necessary to avoid locating your checkpoint at a 
place which contains a control transfer order. The printing oeeurs before any 
transfer of control (to another part of your program) is obeyed. 

(h) It is not necessary to make special provision for ident- 
ifying each checkpoint (assuming that you have decided to insert several 
blocking orders), since Code 95 always prints the location of the checkpoint 
before any other information. 

(5) Blocking orders can be overwritten by Code 95, i.e., it 
is possible to print information at some particular checkpoint the 47th time : 
it is reached, the 58th time it is reached, but at no other times.:. The 
specification tape necessary for this will be discussed later. 

NATURE OF INFORMATION WHICH CAN BE PRINTED AT EACH CHECKPOINT 

At each checkpoint, we may take a number from any place in the 
memory, or from R , or from R , and print it in a number of ways : 

(1 
(2 
(3! 
(*. 



(5 
(6 
(7 



As an order pair 

As a right hand address 

As a left hand address 

As a ten character sexadecimal word 



As a signed integer 

As a signed 12 figure decimal fraction, not rounded 

As a signed 5 figure fraction, not rounded 
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The number of items to be printed at each checkpoint is arbitrary and so is 
the number of different checkpoints* Both are limited only by the memory space 
available for the operation of Code 95. 

Code 95 "will print two line feed and carriage return characters 
before each checkpoint print* but it will not print such characters during 
each checkpoint print unless the programmer so specifies. If the amount of 
printing you want to do at a given checkpoint exceeds the capacity of a 
line on the teletype machines (about 60 characters), you can and should 
specify additional carriage returns and line feeds by means of the specification 
tape * 

If the number to be printed consists of a sign digit only (i.e., 
the sexadecimal word is 8000000000) the following things will be printed: 

Order pair: 80 00 

R, H. address % 

L* H« address: 

Sexadecimal t 8000000000 

Signed integer: -0 

Signed 12 figure fraction: = -000000000000 

Signed 5 figure fraction: = -00000 

Zero is always preeed by a + sign. 

Two spaces are left between any two printed items* 

Nonsignificant zeros are omitted in the printing of integers 
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or addresses* Zero is printed as a single zero* The integer 1255 x 2 is 

printed as + 1235, not as +000000001255- 
THE SPECIFICATION TAPE 

For each checkpoint, we must specify the location of the check- 
point, the nature of the information to be printed at the checkpoint, how often 
the printing is to be suppressed at first, and how often printing should occur 
thereafter until the order is unblocked. This is done as follows: 

(1) Let "c" be the location of the checkpoint* Put cL on the 
specification tape. 

(2) Let "f" be the number of times printing is to be sijppressed 
(f = Ik in the example on page 1 of this write-up)* Put fF on the specifi- 
cation tape, f must lie between and 511 « If f = 0, i.e», if you wish to 
print the very first time your program reaches the blocking order at c, you do 
not need to specify f at all. 



(3) Let "k" "be the number of times printing is to occur before 
the order is unblocked (k = 18 in the example on page 1 of this write-up). Put 
kK on the specification tape* If k = 1 (i.e., if you wish to print once and 
once only at this check point), you need not specify k at all. 

(k) Let a, b, c,*«*, be the addresses of words you wish to have 
printed at this checkpoint* Let W G" be any one of the following seven sexa- 
decimal characters j G - 0, 2, 5, 6, S, N, F« The character G specifies the way 
in which the number is to be printed: 

(i) As an order pair: G = 

(ii) As a right hand address: G = 2 

(iii) As a left hand address: G = 6 

(iv) As a ten~eharacter sexadecimal word: G = S 

(v) As a signed integer: G = N 

(vi) As a signed twelve figure fraction: G = T 

(vii) As a signed five figure decimal fraction: G = 5 

Put on the specification tape: aSG , bSG, ,..., where G. specifies the way 

a d a 

N(a) is to be printed, G, specifies how H(b) is to be printed, and so on. 

If you wish to print the number in R , specify the location of 
word of Code 95, (this is 900 if you use the ILLIAC copy). 

If you wish to print the number in R 2 , specify the location of 
word 1 of Code 95, (this is 901 if you use the ILLIAC copy). 

If you wish to print a line feed and carriage return character* 
specify the symbol "J" on the specification tape. 

(5) After all the checkpoints and the printing at each check* 
point have been specified, we conclude the specification tape with nBB where 
"n" is the location of the first order in your program which you wish to have 
obeyed, and "B" is a sexadecimal character which specifies the nature of the 
control transfer (in practice, B will be one of 0, 2, k, 6, in most cases)* 
The control transfer is accomplished by means of a 2Bn order. 

(6) If we wish to print, say, the order pair at location 12 
during the 10th and 20th times control passes the check point at c, this may 
be done by having 2 check points at the same address: 

e.g. cL 19F 12S0 

cL 9F 12S0 
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MEMORY SPACE NEEDED FOR CODE 95 

Code 95 itself occupies 57 memory positions . However, more 
memory positions must "be allowed after the last word of Code 95 to contain 
the "blocked orders, locations of numbers to "be printed, and so on. Let "j£j J 
"be the number of check-points ( = the number of L's on your specification tape) 
Allow 3 j^ memory positions. Furthermore, allow one memory position for each 
piece of information (word) you wish to have printed out, and one memory 
position for each line feed character ( each J on the specification tape) over 
and above the automatic line feeds. Thus the total number of memory positions 
needed is 

Memory positions necessary = 57 + 3X+ s + J 
where n jtj x is the number of L's on the specification tape, tr s" is the number 
of S r s (not counting the second S in SS, however), and "j" is the number of 
J's. 

READING IN OF CODE 95 

Code 95 is in two parts, both on the same tape* Read in < 
the program to be checked. Then read in Bart I. When Part I is in, the 
ILLIAC stops and the Specification Tape is read in* The ILLIAC stops again 
and Part II is read in* The program then starts. 

ILLIAC COPY OF CODE 95 

The operator's copy uses a bootstrap input which places the 

code at positions beginning with 900 and overwrites the Decimal Order Input* 

If you have no program beyond 899, then you can use this and will have 67 
locations for the list. 
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L5 1L 
46 53L 






1 


L5 F 
26 47L 






Used for SO 


2 


00 F 
00 10F 




-39 
10 x 2 Jy 


3 


L5 F 










26 51L 






Used for S2 


k 


00 IF 
00 IF 






5 


40 OL 
S5 IF 




}-*—"— 


6 


15 F 




*~\ 




26 28L 


, 


r used f ° r s 5 


7 


L5 F 
22 50L 






^ Used for S6 


8 


L5 (m+l)F X 
22 5L 






Used for "closed" 
entry in list 


9 


L5 (ia)F X 






10 


26 Cm)F 


I 


tt 

L5 (m+2)F 






Set suppression count 






S4 3L 










11 


40 (m+a)F 








F 


12 


27 16L 










L5 F 










26 X8L 






"" Used for SS 


13 

14 


L5 F 
22 30L 
92 12 9F 
22 18L 






■"" Used for SN 
Used for J 


15 


L5 F 
26 27L 






" Used for SF 


16 


40 F 
81 4F 








17 


: 50 F 






Convert to decimal address a 




LO 2L 


■ 
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18 


36 21L 
L^ 2L 








19 


74 2L 
S5 23L 








20 


26 16L 
00 1L 




V T 


21 


iA 19L 
h2 22L 






22 


L5 F 




Add address switch to 




26 ( )F 




KSNJForL 


23 


k2 (iu T )F 

27 16L 






— Set count for print 


2k 


81 kF 










26 43L 






25 


L5 9L 








26 46l 






26 


L5 l^L 
26 45L 






27 


00 30F 








26 10L 




Shift address 


28 


k2 32L 
00 20F 


11 




Set up address of check point 


29 


hG 32L 
^6 30L 








30 


L5 (n)F 
10 2QF 






Replace L. H. order at n "by 
26 (m)F 


31 


L5 9L 
00 20F 








32 


50 (n)F 
kO (n)F 






Save order in Q 


33 


S5 F 
10 ^OF 






Place 00 nF as L«H. order and 


3^ 


L5 F 
00 20F 






" L-»H. address of n. 


35 


40 (m+2)F^ 






As R. H« order in (m+2) 




L5 8L J 


\. Place entry in list 



Dl 



LOCATION 


ORDER 


NOTES PAGE 3 Dl 


36 


40 (jih-IJF* 
L5 5L 








37 


40 (n)F* 
L5 37L 




■ 


Save address for use of K 


38 


46 23L 
L5 35L 




* 




39 


46 lOL 
46 11L 






■- Save address for use of F 


4o 


L5 4L 
L4 4l 






Advance m by 1 or 3* 


41 


L4 4L 
L4 9L 








42 


40 9L 








43 


22 51L 
L4 20L 












' Construct list entry 


, 




42 44L 










44 


00 55F 






L5 aF 26 pF from a x 2~^ 






L4 ( )F 






2 

and L5 F 2.^ pF 


S 


4 5 


40 (m)F 








46 


27 4lL 
10 16F 














Construct and store L5 (m)F 2B aF 






80 4f 








. N 


47 


50 4l 

00 12F 






L5 (m)F 2B aF in IL 




48 


L4 F 










49 


24 49L 
40 IL 
81 40F 




-,<. 


Wait for new tape 








Store 2 5 6 /l0 11 at end of list 


50 


40 (m)F 










L5 10L 






To D. P. I. read in program to 3L 


51 


22 1014F 
46 37L 




— 


omsards 


52 


46 45L 
46 50L 






Set all addresses dependent on nu 


53 


L4 4l 
46 8L 
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OBDER 
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5 4 


46 36L 
l4 to 








55 


46 35L 
27 16L 










24 IB 








SPACES 








57 L5L 




a^/io 11 




L85F6 




KEY: 


X means — 




m = 5^L originally 




is = current entry in list 




n = location of current check point 




a = address of number to be printed 


3 


80. F 
00 (l)F 






if 


00 F 








00 F 


y 




5 


22 (n)F 
LO 10L 






6 


46 14L 


m 






46 15L 


m 




T 


L4 9L 








46 21L 


m+2 




8 


46 11L 


m+2 






46 25L 


m+2 




9 


S5 2F 








40 1L 


q. 


Save Q 


10 


09 IF 








10 9F 


-2~ 9 


Store f-1, n, (fc*H# order of n) 


11 


L4 (m+2 )F 








46 5L 


n 




12 


40 4l 








36 25L 




Bypass print 
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13 


46 25L 
46 23L 


n 
11 






14 


L5 (m-l)F 
LO 3L 
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— Have we finished printing? 


15 


42 (m-l)F 
00 27F 








16 


36 23L 


Ho 


-^ Yes 




92 133F 


1 


Carriage returns (2) 


17 


L5 23L 
22 50L 






Print n 


18 


82 40F 








92 965F 




Two spaces 


19 


19 18F 
L4 21L 






Increase m 


20 


36 46L 
46 21L 




Print R. H« order 


21 


L5 (m+2)F 








32 25L 




End Print 


22 


40: 55L 








26 55L 




— * 


23 


L5 (n)F 
10 20F 








24 


L5 4L 
00 20F 






— Restore program: 


25 


40 (n or m+2)F 








50 1L 






Return to program. 


26 


L5 L 
22 4L 








27 


40 55L 
22 29L 






28 


40 55L 








L5 4% 






Set to count 5 


29 


46 54l 










43 3L 
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50 


L5 55L 
40 55L 






""" Print Sign 


51 


52 52L 
92 704F 


— 




"* 


52 


26 55L 










92 642F 


+ 






55 


L7 55L 
50 2L 






_ Modulus to Q 


54 


10 59F 










L7 5L 








55 


52 52L 
75 2L 


10 






56 


LO 51 
52 59L 






Test for 




57 


L4 5L 
00 56F 






— Print decimal 


58 


82 4F 
10 :4of 






digit 


59 


45 5L 
L5 54L 






4o 


LO 50L 
46 54l 






Digit Count 


4i 


32 55L 










L5 52L 






Restore digit count 


42 


46 54L 










LI 5L 








^5 


00 2F 
52 44L 






Reset zero suppression 


44 


92 02F 
19 33F 








45 


42 5L 
22 18L 




_ 




46 


L5 55L 
00 20F 






Move R. H. order to L. H. position 


*7 


40 55L 
LI 21L 






Switch 
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48 


40 21L 
L5 55L 




Print function 




^9 


82 328F 
92 961F 




Space 




50 


10 71F 










10 20F 




Convert address 


to an integer inQ 


51 


50 2L 
10 12F 








52 


11 795F 


(27) 








53 


L5 50L 
74 (u)F 
10 9F 




2 36 /l0 22 + 47 x 


2 -59 


Convert 


54 


10 (795 )F 


27 






Integer 




26 36L 








into a 


55 


00 F 
26 L 

26 IN 


X 




fraction 
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